//=================================\\
           v3 Arcade 1.0.8
         for vBulletin 3.7.x
Updated by The MOnster
\\=================================//

Thanks for downloading v3 Arcade, version 1.0.7 for vBulletin 3.7.X.

"v3 Arcade" is the third Arcade system I've written for vBulletin. It's coded from scratch, not a port of an older version - and because it was coded specifically for vBulletin 3.5 it uses the product system for code modifications, and utilizes AJAX technology throughout. Here's a brief rundown of the features in this version of v3 Arcade. 

- Supports both v3 Arcade and iB games.
- Download *legal* free, premium and multiplayer games directly from v3arcade.com to your Arcade installation.
- Import script to convert your old v3 Arcade installation. (A script to import games, scores and news from old IBPro installations is available here, thanks to Tigga: http://www.v3arcade.com/forums/showthread.php?t=324)
- AJAX based instant ratings, for simple to use game ratings.
- AJAX based inline score moderation.
- AJAX based instant game searching.
- Tabbed, customizable categories.
- Challenge system for one-on-one contests.
- User-permission based settings for email/PM notification, challenge settings.
- Streamlined viewing modes for users with lower resolutions.
- AJAX based quick stats, for viewing statistics by passing the cursor over a username.
- Mass import tools for importing games in bulk.
- Reverse and decimal based scoring.
- Arcade-only closure with customizable message.
- Per game criteria, allows you to control access to games by reputation, posts, registration length.
- Postbit based awards.
- Personalized recommendations for other games users might like, based on what theyre playing.
- Quick stats, letting a user know how many other scores are above and below theirs.
- Score ranking.
- Admin customizable score feedback, displays a message based on how well as user has done.
- Numerous Admin CP settings to control things like popup opacity, maximum comment length, hover delay length, and numerous other behaviors. 
- Full admin control over the types of content allowed in comments (BB code, HTML, smilies, etc.)
- Usergroup based access permissions.
- Fully phrased, for each translation into other languages.
- An ever growing collection of third party add-ons, thanks to Oblivion Knight.
- A slick, professional layout.


//=================================\\
              Change Log
\\=================================//

1.0.0 - First public release.
-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-

1.0.1 - Bug fixes and feature release.
-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
- More visible postbit award presence.
- Reverse scoring option added to games.
- Data dictionary implementation, makes sure the Arcade database changes are correctly made.
- Template grouping.
- "Posts in the last 24 hours" criteria added to games.
- Other bug fixes.

1.0.2 - Bug fixes.
-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
- Hopefully this will be the last big bug fix release. The problem is table prefixes. Because of one bug early on, it caused a whole load of different issues when using the product system for upgrading. A whole new set of problems arose in 1.0.1.

1.0.5 - New features and bug fixes.
-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
- Added search on/off toggle function in Admin CP.
- Opera compatibility fixed.
- Welcome message now an Admin CP option.
- Use "Miniature Mode" By Default option added to the Admin CP.
- New AJAX based favorites system.
- Hooks in place for vbBux integration (coming soon from CMX_CMGSCCC)
- Per-category on/off settings.
- Default user settings for challenges and notifications.

- Database error when pruning a users scores with table prefix. 
http://www.v3arcade.com/forums/vbugs.php?do=view&vbug_id=88

- Database error when viewing distinct high scores when the table is empty.
http://www.v3arcade.com/forums/vbugs.php?do=view&vbug_id=62

- Notification bug fixes, users should now be notified based on their Arcade settings.
http://www.v3arcade.com/forums/vbugs.php?do=view&vbug_id=56

- Timestamp bug fixed for news and events.
http://www.v3arcade.com/forums/vbugs.php?do=view&vbug_id=67

1.0.6 - Bug fixes.
-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
- Fixed a bug where unregistered users could challenge people in the Arcade.
- "Wipe All Scores" tool added.
- "arcade_award_bit" template is now cached correctly.

1.0.7 - Features and Bug fixes.
-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
- Guests can now play games, but their scores aren't recorded. If a guest plays a game, they're asked to register if they want their score recorded afterwards.
- Admins can now wipe all scores through the Admin CP.
- Admins now have a tool to enable challenges by default for all users.
- Usergroup requirements for games are now in place.
- Admins can now choose to flip the columns and have the smaller panel on the left, with the larger content area on the right.
- News & Events - now entries contain links to games.
- Numerous bug fixes.
- Mass category changer for altering game categories en masse.
- High score rebuilder in the Admin CP.
- 50 new titles added to the v3arcade.com game store

//=================================\\
            Branding Free
\\=================================//

All v3 Arcade installations carry and require a small "v3 Arcade" logo in the footer, as well as the text "Powered by v3 Arcade" which links to http://www.v3arcade.com. A "branding-free" license is available at the cost of $60 USD per installation, available from www.v3arcade.com. 

A branding-free license entitles you to:
- Remove the "v3 Arcade" logo and "Powered by v3 Arcade" link from the footer of all Arcade pages.
- Premium support on v3Arcade.com.
- A input on what new features you want to see added to the next release, via the "Development Discussion" forum.
- Access to v3 Arcade beta releases.
- Access to other beta events. (E.g. live multiplayer games, new vBulletin related products, etc.)


//=================================\\
          www.v3arcade.com
\\=================================//

If you're looking for more games, add-ons, support, tutorials, or anything Arcade related - www.v3arcade.com is the place to go. :)


//=================================\\
            Installation
\\=================================//

Installation in three easy steps:

1. Upload all the files from the "files" directory in this zip into your forums directory.
2. Import product-v3arcade.xml as a product. (Via "Plugin System" > "Manage Products" > "Add/Import Product" in your Admin CP.)
3. Edit templates as instructed below.

-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-


In the template: USERCP_SHELL
=============================
FIND:
=============================
<tr>
	<td class="$navclass[profile]" nowrap="nowrap"><a class="smallfont" href="profile.php?$session[sessionurl]do=editprofile">$vbphrase[edit_profile]</a></td>
</tr>
=============================
ABOVE THIS, ADD:
=============================
<!-- v3 Arcade -->
<tr>
	<td class="$navclass[arcade]" nowrap="nowrap"><a class="smallfont" href="profile.php?$session[sessionurl]do=editarcade">$vbphrase[edit_arcade_options]</a></td>
</tr>
<!-- /v3 Arcade -->
=============================


In the template: postbit OR postbit_legacy (depending on which one you use)
=============================
FIND:
=============================
	</table>
</div>
<!-- / post $post[postid] popup menu -->
=============================
ABOVE THIS, ADD:
=============================
<!-- v3 Arcade -->
	<if condition="$post['arcadeawards']">
	<tr><td class="thead"><phrase 1="$post[username]">$vbphrase[xs_arcade_awards]</phrase></a></td></tr>
	$post[arcadeawards]
	</if>
	<if condition="($post['arcadeoptions'] & 1) AND $post['userid']!=$bbuserinfo['userid']">
	<tr><td class="thead">$vbphrase[arcade]</a></td></tr>
	<tr><td class="vbmenu_option"><a href="arcade.php?do=newchallenge&userid=$post[userid]"><phrase 1="$post[username]">$vbphrase[challenge_x_in_the_arcade]</phrase></td></tr></if>
<!-- /v3 Arcade -->
=============================

=============================
FIND:
=============================
<a class="bigusername" href="member.php?$session[sessionurl]u=$post[userid]">$post[musername]</a> 
=============================
REPLACE WITH:
=============================
<a class="bigusername" href="member.php?$session[sessionurl]u=$post[userid]">$post[musername]</a><!-- v3 Arcade --> <if condition="$post['arcadeawards']"><a class="bigusername" href="member.php?$session[sessionurl]u=$post[userid]"><img src="$vboptions[arcadeimages]/trophy.gif" align="absmiddle" alt="$vbphrase[arcade_champion]" border="0" /></a></if>
<!-- /v3 Arcade -->
=============================


In the template: navbar
=============================
FIND:
=============================
<td class="vbmenu_control"><a href="calendar.php$session[sessionurl_q]">$vbphrase[calendar]</a></td>
=============================
BELOW THIS, ADD:
=============================
<!-- v3 Arcade -->
<td class="vbmenu_control"><a href="arcade.php$session[sessionurl_q]">Arcade</a></td>
<!-- /v3 Arcade -->
=============================


-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-

That's all folks! Don't forget to set your usergroup permissions after installing, in order to access the Arcade.

-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-

//=================================\\
          Many thanks to...
\\=================================//

- All branding-free customers and donors, for supporting the project.
- Oblivion Knight, for his work on the forums and great add-ons.
- Snowy, for his work on the forums.
- Andreas a.k.a. KirbyDE, for his vB 3.5 tutorials.

//=================================\\
              Copyright
\\=================================//

All code in distributed in this zip is Copyright 2005 John Warwick, with the following exceptions:
class_tar.php - Credits within.
All Actionscript code within the included .swf files, unless otherwise noted.

